home *** CD-ROM | disk | FTP | other *** search
/ Kit PC World De Ampliacion De Windows 95 / Kit PC World de ampliacion de Windows 95.iso / clarion / cw15 / examp15.z / EDITPLAC.DOC < prev    next >
Text File  |  1995-09-08  |  3KB  |  65 lines
  1.                          Edit in Place Documentation
  2.                          ---------------------------
  3.  
  4. This example is based on information found in help topics
  5. and the Language Reference Manual. This example DOES NOT take
  6. in consideration several situations such as duplicate keys,
  7. network versions, etc.
  8.  
  9. When developing  Edit in Place, you first go to the window
  10. formatter. Select the list box and pull up the list box 
  11. properties dialog. Next you check off IMM and COLUMN. The
  12. COLUMN attribute allows you to highlight a multi-column list
  13. box, field by field. The IMM attribute specifies that
  14. an event will be generated every time a user presses a key.
  15.  
  16. Now you create a local data field (we'll call it EditEntry)
  17. and place it somewhere on the window. You then go into the
  18. field properties dialog.Next you go into the position button 
  19. and check off hide. This control or field, EditEntry, is where 
  20. the edit in place occurs.  By using the property, Prop:Edit, 
  21. this field will automatically unhide, resize and move to the 
  22. current highlighted record at runtime. Now that your window is 
  23. set up, it is time to code.
  24.  
  25. You would probably want to activate edit in place when your user
  26. double clicks with their mouse. For this reason, you would
  27. select the embedded source point called 'Browse Double
  28. Click Handler' to enter code that will handle what happens.
  29. Simply put, the code at this embed point does the following
  30. things:*
  31.  
  32. 1. Retrieves the highlighted record from the queue
  33. 2. Assign the key field the value of its corresponding current
  34.    queue element. This will allow us to set up the key field for
  35.    future use in retrieving the correct record for file maintenance.
  36. 3. Format the EditEntry control to have the same picture as the
  37.    current selected column.
  38. 4. Check which column is being used and write the contents of
  39.    the correct queue field to the EditEntry control.
  40. 5. Activate the edit in place.
  41.  
  42. Now that we put in code to allow them to edit in place, we
  43. must now code for what happens after they type in their
  44. corrections. In the accepted embedded source point, we do 
  45. the following:*
  46.  
  47. 1.  Retrieve the record from the file.  (Remember that we set
  48.     this up in double click handling) **
  49. 2.  Assign the queue fields to the file fields.
  50. 3.  Write the changes to the file on disk.
  51. 4.  Write the changes to the queue.
  52. 4.  Turn off edit in place.
  53.  
  54. Hopefully, this example will give you some insight on Edit in
  55. Place and a foundation to add it to your own program.
  56.  
  57. *   The code for the steps are in the embedded source window
  58.     of the browse for your review.
  59. **  Assumption is that the records already exist in the file.
  60.  
  61. NOTE:  In developing this example, I have encountered a bug
  62. with the Prop:Edit property. This problem has been logged as 1816.
  63. For further information, you can down load the bugs database.
  64.  
  65.